ftw.tooltip 1.1.4

简介

使用ftw.tooltip，您可以动态地向每个dom添加工具提示 元素，可由jquery选择并允许title属性。

认证日期：2013年1月

安装

将ftw.tooltip添加到构建配置：

[instance]
eggs =
  ftw.tooltip

导入ftw.tooltip默认配置文件。

用法

基本上，您必须注册名为ITooltipSource的适配器。 它们将被一个视图查询，该视图生成必要的js代码。

有两个示例工具提示源适配器，以显示它们是如何工作的

• 静态文本示例。
• 动态文本示例，读取所选dom元素的title属性。

您可以通过注册以下适配器在站点上加载这两个示例：

>>> from ftw.tooltip.demo_tooltip_source import (DemoStaticTooltipSource,
...    DemoDynamicTooltipSource)
>>> from zope.component import provideAdapter
>>> provideAdapter(DemoStaticTooltipSource, name="demo1")
>>> provideAdapter(DemoDynamicTooltipSource, name="demo2")

或者如果您使用的是zcml:

<adapter
    factory="ftw.tooltip.demo_tooltip_source.DemoStaticTooltipSource" name="demo1" />
<adapter
    factory="ftw.tooltip.demo_tooltip_source.DemoDynamicTooltipSource" name="demo2" />

• “演示1”在门户徽标上放置工具提示。
• “demo2”将工具提示放在每个全局导航元素上，并将给定的title属性显示为工具提示。

示例

很容易定义一个新的ITooltipSource适配器。 以下示例将显示工具提示“This is the edit bar”only on folderish类型（检查全局条件），当然只有当“documenteditable”时 css类可用：

>>> from zope.component import adapts
>>> from zope.interface import implements, Interface
>>> from ftw.tooltip.interfaces import ITooltipSource
>>> from plone.app.layout.navigation.interfaces import INavigationRoot
>>> from Products.CMFCore.interfaces import IFolderish

>>> class EditBarTooltip(object):
...     """Base demo static tooltip source. Use a given text"""
...     implements(ITooltipSource)
...     adapts(Interface, Interface)
...
...     def __init__(self, context, request):
...         self.context = context
...         self.request = request
...
...     def global_condition(self):
...         return bool(IFolderish.providedBy(self.context))
...
...     def tooltips(self):
...         return [{
...             'selector': u'#edit-bar',
...             'text': u'This is the edit bar',
...             'condition': 'div.documentEditable'}]

使用zcml注册适配器：

>>> <adapter
...    factory="your.module.EditBarTooltip" name="my_edit_bar_tooltip" />

您可能需要使用自己的工具提示布局： 只需注册一个名为“ftw_tooltip_layout”的browserview并返回您喜欢的工具提示布局。

也可以通过注册BrowserView来完全自定义工具提示参数 命名为“ftw_tooltip_custom_config”-有关更多详细信息，请查看jquerytools文档。

小型定制示例：

{
    offset: [-10, 10],
    position: 'right center',
    opacity: '0.7',
}

示例：使用现有HTML的工具提示

也可以使用html标记作为数据源（必须是selctor的同级），而不是title属性。在这种情况下，只需稍作调整即可：

ITooltipSource适配器应该在^{tt7}中返回一个js选择器$ 属性而不是文本属性：

>>> from zope.component import adapts
>>> from zope.interface import implements, Interface
>>> from ftw.tooltip.interfaces import ITooltipSource
>>> from plone.app.layout.navigation.interfaces import INavigationRoot
>>> from Products.CMFCore.interfaces import IFolderish

>>> class EditBarTooltip(object):
...     """Base demo static tooltip source. Use a given text"""
...     implements(ITooltipSource)
...     adapts(Interface, Interface)
...
...     def __init__(self, context, request):
...         self.context = context
...         self.request = request
...
...     def global_condition(self):
...         return bool(IFolderish.providedBy(self.context))
...
...     def tooltips(self):
...         return [{
...             'selector': u'#edit-bar',
...             'condition': 'div.documentEditable',
...             'content': u'.tabbedview-tooltip-data'}]

HTML结构中的唯一约束wich必须得到注意，即内容标记必须是选择器标记的同级。例如：

... <a href="/edit_bar" id="edit_bar"></a>
... <div class="tabbedview-tooltip-data">
...     <div class="tooltip-content">
...         <div class="tooltip-header">Tooltip Headeer</div>
...         <div class="tooltip-breadcrumb">Lorem ipsum ...</div>
...     </div>
... </div>

链接

• GitHub项目主存储库：https://github.com/4teamwork/ftw.tooltip
• 问题跟踪程序：https://github.com/4teamwork/ftw.tooltip/issues
• pypi上的包：http://pypi.python.org/pypi/ftw.tooltip
• 连续积分：https://jenkins.4teamwork.ch/search?q=ftw.tooltip

版权所有

此软件包由4teamwork版权所有。

ftw.tooltip根据GNU通用公共许可证第2版获得许可。

更改日志

标签：

• 工具
• from
• import
• self
• div
• 示例
• context
• ftw
• 动态
• tooltip

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• pytwits

  pytwits是stocktwits的rest-api的python包装器。

• odoo10-addon-web-ckeditor4

  提供一个小部件，用于使用ckeditor 4.x编辑html字段

• django-user-messages

  Offline addon for django.contrib messages.

• tracefront

  格式回溯更好。

• wmowonen.theme

  世界气象组织Wonen NH主题（2014）

• pwgen-passphrase

  基于安全字表的密码短语生成器

• nemlite

  用于复制nemde调度过程的工具。

• petl_django

  django模型数据的petl视图类。

• neptune-cli

  海王星客户端图书馆

• robotframework-zeep

  面向robot框架的web服务测试库

• juju-scalewa

  与居居居整合

• sentry-slack

  a sentry extension which posts notifications to slack（https://slack.com/）。

• tensorflow-estimator

  张量流估计器。

• goodread

  使用基于注释的断言进行标记的doctest。python/javascript/ruby/php测试运行程序和hackmd.io集成。

• jojo

  jojo在python中的编程冒险