feat: Add comprehensive documentation suite and reorganize project structure
- Created complete documentation in docs/ directory - Added PROJECT_OVERVIEW.md with feature highlights and getting started guide - Added ARCHITECTURE.md with system design and technical details - Added SECURITY.md with comprehensive security implementation guide - Added DEVELOPMENT.md with development workflows and best practices - Added DEPLOYMENT.md with production deployment instructions - Added API.md with complete REST API documentation - Added CONTRIBUTING.md with contribution guidelines - Added CHANGELOG.md with version history and migration notes - Reorganized all documentation files into docs/ directory for better organization - Updated README.md with proper documentation links and quick navigation - Enhanced project structure with professional documentation standards
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
export default function addSlide(index, slides) {
|
||||
const swiper = this;
|
||||
const {
|
||||
params,
|
||||
activeIndex,
|
||||
slidesEl
|
||||
} = swiper;
|
||||
let activeIndexBuffer = activeIndex;
|
||||
if (params.loop) {
|
||||
activeIndexBuffer -= swiper.loopedSlides;
|
||||
swiper.loopDestroy();
|
||||
swiper.recalcSlides();
|
||||
}
|
||||
const baseLength = swiper.slides.length;
|
||||
if (index <= 0) {
|
||||
swiper.prependSlide(slides);
|
||||
return;
|
||||
}
|
||||
if (index >= baseLength) {
|
||||
swiper.appendSlide(slides);
|
||||
return;
|
||||
}
|
||||
let newActiveIndex = activeIndexBuffer > index ? activeIndexBuffer + 1 : activeIndexBuffer;
|
||||
const slidesBuffer = [];
|
||||
for (let i = baseLength - 1; i >= index; i -= 1) {
|
||||
const currentSlide = swiper.slides[i];
|
||||
currentSlide.remove();
|
||||
slidesBuffer.unshift(currentSlide);
|
||||
}
|
||||
if (typeof slides === 'object' && 'length' in slides) {
|
||||
for (let i = 0; i < slides.length; i += 1) {
|
||||
if (slides[i]) slidesEl.append(slides[i]);
|
||||
}
|
||||
newActiveIndex = activeIndexBuffer > index ? activeIndexBuffer + slides.length : activeIndexBuffer;
|
||||
} else {
|
||||
slidesEl.append(slides);
|
||||
}
|
||||
for (let i = 0; i < slidesBuffer.length; i += 1) {
|
||||
slidesEl.append(slidesBuffer[i]);
|
||||
}
|
||||
swiper.recalcSlides();
|
||||
if (params.loop) {
|
||||
swiper.loopCreate();
|
||||
}
|
||||
if (!params.observer || swiper.isElement) {
|
||||
swiper.update();
|
||||
}
|
||||
if (params.loop) {
|
||||
swiper.slideTo(newActiveIndex + swiper.loopedSlides, 0, false);
|
||||
} else {
|
||||
swiper.slideTo(newActiveIndex, 0, false);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,34 @@
|
||||
export default function appendSlide(slides) {
|
||||
const swiper = this;
|
||||
const {
|
||||
params,
|
||||
slidesEl
|
||||
} = swiper;
|
||||
if (params.loop) {
|
||||
swiper.loopDestroy();
|
||||
}
|
||||
const appendElement = slideEl => {
|
||||
if (typeof slideEl === 'string') {
|
||||
const tempDOM = document.createElement('div');
|
||||
tempDOM.innerHTML = slideEl;
|
||||
slidesEl.append(tempDOM.children[0]);
|
||||
tempDOM.innerHTML = '';
|
||||
} else {
|
||||
slidesEl.append(slideEl);
|
||||
}
|
||||
};
|
||||
if (typeof slides === 'object' && 'length' in slides) {
|
||||
for (let i = 0; i < slides.length; i += 1) {
|
||||
if (slides[i]) appendElement(slides[i]);
|
||||
}
|
||||
} else {
|
||||
appendElement(slides);
|
||||
}
|
||||
swiper.recalcSlides();
|
||||
if (params.loop) {
|
||||
swiper.loopCreate();
|
||||
}
|
||||
if (!params.observer || swiper.isElement) {
|
||||
swiper.update();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
export default function prependSlide(slides) {
|
||||
const swiper = this;
|
||||
const {
|
||||
params,
|
||||
activeIndex,
|
||||
slidesEl
|
||||
} = swiper;
|
||||
if (params.loop) {
|
||||
swiper.loopDestroy();
|
||||
}
|
||||
let newActiveIndex = activeIndex + 1;
|
||||
const prependElement = slideEl => {
|
||||
if (typeof slideEl === 'string') {
|
||||
const tempDOM = document.createElement('div');
|
||||
tempDOM.innerHTML = slideEl;
|
||||
slidesEl.prepend(tempDOM.children[0]);
|
||||
tempDOM.innerHTML = '';
|
||||
} else {
|
||||
slidesEl.prepend(slideEl);
|
||||
}
|
||||
};
|
||||
if (typeof slides === 'object' && 'length' in slides) {
|
||||
for (let i = 0; i < slides.length; i += 1) {
|
||||
if (slides[i]) prependElement(slides[i]);
|
||||
}
|
||||
newActiveIndex = activeIndex + slides.length;
|
||||
} else {
|
||||
prependElement(slides);
|
||||
}
|
||||
swiper.recalcSlides();
|
||||
if (params.loop) {
|
||||
swiper.loopCreate();
|
||||
}
|
||||
if (!params.observer || swiper.isElement) {
|
||||
swiper.update();
|
||||
}
|
||||
swiper.slideTo(newActiveIndex, 0, false);
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
export default function removeAllSlides() {
|
||||
const swiper = this;
|
||||
const slidesIndexes = [];
|
||||
for (let i = 0; i < swiper.slides.length; i += 1) {
|
||||
slidesIndexes.push(i);
|
||||
}
|
||||
swiper.removeSlide(slidesIndexes);
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
export default function removeSlide(slidesIndexes) {
|
||||
const swiper = this;
|
||||
const {
|
||||
params,
|
||||
activeIndex
|
||||
} = swiper;
|
||||
let activeIndexBuffer = activeIndex;
|
||||
if (params.loop) {
|
||||
activeIndexBuffer -= swiper.loopedSlides;
|
||||
swiper.loopDestroy();
|
||||
}
|
||||
let newActiveIndex = activeIndexBuffer;
|
||||
let indexToRemove;
|
||||
if (typeof slidesIndexes === 'object' && 'length' in slidesIndexes) {
|
||||
for (let i = 0; i < slidesIndexes.length; i += 1) {
|
||||
indexToRemove = slidesIndexes[i];
|
||||
if (swiper.slides[indexToRemove]) swiper.slides[indexToRemove].remove();
|
||||
if (indexToRemove < newActiveIndex) newActiveIndex -= 1;
|
||||
}
|
||||
newActiveIndex = Math.max(newActiveIndex, 0);
|
||||
} else {
|
||||
indexToRemove = slidesIndexes;
|
||||
if (swiper.slides[indexToRemove]) swiper.slides[indexToRemove].remove();
|
||||
if (indexToRemove < newActiveIndex) newActiveIndex -= 1;
|
||||
newActiveIndex = Math.max(newActiveIndex, 0);
|
||||
}
|
||||
swiper.recalcSlides();
|
||||
if (params.loop) {
|
||||
swiper.loopCreate();
|
||||
}
|
||||
if (!params.observer || swiper.isElement) {
|
||||
swiper.update();
|
||||
}
|
||||
if (params.loop) {
|
||||
swiper.slideTo(newActiveIndex + swiper.loopedSlides, 0, false);
|
||||
} else {
|
||||
swiper.slideTo(newActiveIndex, 0, false);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user