# dom-align **Repository Path**: mirrors_fis-components/dom-align ## Basic Information - **Project Name**: dom-align - **Description**: Fork from https://github.com/yiminghe/dom-align.git - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-08-08 - **Last Updated**: 2026-10-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # dom-align --- align source html element with target html element flexibly. [![NPM version][npm-image]][npm-url] [![build status][travis-image]][travis-url] [![Test coverage][coveralls-image]][coveralls-url] [![gemnasium deps][gemnasium-image]][gemnasium-url] [![node version][node-image]][node-url] [![npm download][download-image]][download-url] [![Sauce Test Status](https://saucelabs.com/buildstatus/dom-align)](https://saucelabs.com/u/dom-align) [![Sauce Test Status](https://saucelabs.com/browser-matrix/dom-align.svg)](https://saucelabs.com/u/dom-align) [npm-image]: http://img.shields.io/npm/v/dom-align.svg?style=flat-square [npm-url]: http://npmjs.org/package/dom-align [travis-image]: https://img.shields.io/travis/yiminghe/dom-align.svg?style=flat-square [travis-url]: https://travis-ci.org/yiminghe/dom-align [coveralls-image]: https://img.shields.io/coveralls/yiminghe/dom-align.svg?style=flat-square [coveralls-url]: https://coveralls.io/r/yiminghe/dom-align?branch=master [gemnasium-image]: http://img.shields.io/gemnasium/yiminghe/dom-align.svg?style=flat-square [gemnasium-url]: https://gemnasium.com/yiminghe/dom-align [node-image]: https://img.shields.io/badge/node.js-%3E=_0.10-green.svg?style=flat-square [node-url]: http://nodejs.org/download/ [download-image]: https://img.shields.io/npm/dm/dom-align.svg?style=flat-square [download-url]: https://npmjs.org/package/dom-align ## Screenshot ## Install [![dom-align](https://nodei.co/npm/dom-align.png)](https://npmjs.org/package/dom-align) ## Feature * support ie6+ chrome firefox * support align points and offset * support auto adjust according to visible area ## Online Demo * http://yiminghe.github.io/dom-align/examples/ ## Usage ```js var domAlign = require('dom-align'); // use domAlign // sourceNode's initial style should be position:absolute;left:-9999px;top:-9999px; domAlign(sourceNode, targetNode, { points: ['tl', 'tr'], // align top left point of sourceNode with top right point of targetNode offset: [10, 20], // the offset sourceNode by 10px in x and 20px in y, targetOffset: ['30%','40%'], // the offset targetNode by 30% of targetNode width in x and 40% of targetNode height in y, }); ``` ## API ### void domAlign(source: HTMLElement, target: HTMLElement, alignConfig: Object):Function #### alignConfig object details
name type description
points String[2] move point of source node to align with point of target node, such as ['tr','cc'], align top right point of source node with center point of target node. point can be 't'(top), 'b'(bottom), 'c'(center), 'l'(left), 'r'(right)
offset Number[2] offset source node by offset[0] in x and offset[1] in y. If offset contains percentage string value, it is relative to sourceNode region.
targetOffset Number[2] offset target node by offset[0] in x and offset[1] in y. If targetOffset contains percentage string value, it is relative to targetNode region.
overflow Object if adjustX field is true, then will adjust source node in x direction if source node is invisible. if adjustY field is true, then will adjust source node in y direction if source node is invisible.
useCssRight Boolean whether use css right instead of left to position
useCssBottom Boolean whether use css bottom instead of top to position
## Development ``` npm install npm start ``` ## Example http://localhost:8020/examples/ ## Test Case http://localhost:8020/tests/runner.html?coverage ## Coverage http://localhost:8020/node_modules/rc-server/node_modules/node-jscover/lib/front-end/jscoverage.html?w=http://localhost:8020/tests/runner.html?coverage ## License dom-align is released under the MIT license.