From 3d2fda7dd39e2363682f1fa353c951ab0d44ddfa Mon Sep 17 00:00:00 2001 From: Fulup Ar Foll Date: Tue, 9 Feb 2016 18:40:49 +0100 Subject: Implemented URL query parsing for initial token /opa/?token=abcde --- .../tether/docs/3-Advanced/1-embedding_tether.md | 9 ++++ .../tether/docs/3-Advanced/2-extending_tether.md | 54 ++++++++++++++++++++++ 2 files changed, 63 insertions(+) create mode 100644 afb-client/bower_components/tether/docs/3-Advanced/1-embedding_tether.md create mode 100644 afb-client/bower_components/tether/docs/3-Advanced/2-extending_tether.md (limited to 'afb-client/bower_components/tether/docs/3-Advanced') diff --git a/afb-client/bower_components/tether/docs/3-Advanced/1-embedding_tether.md b/afb-client/bower_components/tether/docs/3-Advanced/1-embedding_tether.md new file mode 100644 index 0000000..f47be16 --- /dev/null +++ b/afb-client/bower_components/tether/docs/3-Advanced/1-embedding_tether.md @@ -0,0 +1,9 @@ +## Embedding Tether + +Tether is designed to be embeddable in other libraries. + +There is one thing you should think about doing to create an embedded Tether: + +- Set the `classPrefix` of the tethers you create. That prefix will replace `'tether'` in +all of the classes. You can also disable classes you don't intend on using with the `classes` +option. diff --git a/afb-client/bower_components/tether/docs/3-Advanced/2-extending_tether.md b/afb-client/bower_components/tether/docs/3-Advanced/2-extending_tether.md new file mode 100644 index 0000000..6a13e68 --- /dev/null +++ b/afb-client/bower_components/tether/docs/3-Advanced/2-extending_tether.md @@ -0,0 +1,54 @@ +Extending Tether +----- + +Tether has a module system which can be used to modify Tether's positioning, or just do something each time the Tether is moved. + +Tether has an array called `Tether.modules`, push onto it to add a module: + +```coffeescript +Tether.modules.push + position: ({top, left}) -> + top += 10 + + {top, left} +``` + +#### Position + +Your position function can either return a new object with `top` and `left`, `null`/`undefined` to leave the coordinates unchanged, or +`false` to cancel the positioning. + +The position function is passed an object with the following elements: + +```javascript +{ + left, // The element's new position, from the top left corner of the page + top, + targetAttachment, // The targetAttachment, with 'auto' resolved to an actual attachment + targetPos, // The coordinates of the target + attachment, // The attachment, as passed in the option + elementPos, // The coordinates of the element + offset, // The offset, after it's converted into pixels and the manual offset is added + targetOffset, // The attachment is converted into an offset and is included in these values + manualOffset, // The manual offset, in pixels + manualTargetOffset +} +``` + +It is called with the Tether instance as its context (`this`). + +#### Initialize + +Modules can also have an `initialize` function which will be called when a new tether is created. The initialize function +is also called with the Tether instance as its context. + +```coffeescript +Tether.modules.push + initialize: -> + console.log "New Tether Created!", @ +``` + +#### Examples + +[Constraints](https://github.com/HubSpot/tether/blob/master/coffee/constraint.coffee) and [shift](https://github.com/HubSpot/tether/blob/master/coffee/shift.coffee) are both implemented as modules. +[Mark Attachment](https://github.com/HubSpot/tether/blob/master/coffee/markAttachment.coffee) is used by the docs. -- cgit 1.2.3-korg