<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title> Module: Brauser::Queries — Documentation by YARD 0.8.6.2 </title> <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" /> <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" /> <script type="text/javascript" charset="utf-8"> hasFrames = window.top.frames.main ? true : false; relpath = '../'; framesUrl = "../frames.html#!" + escape(window.location.href); </script> <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script> <script type="text/javascript" charset="utf-8" src="../js/app.js"></script> </head> <body> <div id="header"> <div id="menu"> <a href="../_index.html">Index (Q)</a> » <span class='title'><span class='object_link'><a href="../Brauser.html" title="Brauser (module)">Brauser</a></span></span> » <span class="title">Queries</span> <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div> </div> <div id="search"> <a class="full_list_link" id="class_list_link" href="../class_list.html"> Class List </a> <a class="full_list_link" id="method_list_link" href="../method_list.html"> Method List </a> <a class="full_list_link" id="file_list_link" href="../file_list.html"> File List </a> </div> <div class="clear"></div> </div> <iframe id="search_frame"></iframe> <div id="content"><h1>Module: Brauser::Queries </h1> <dl class="box"> <dt class="r1">Included in:</dt> <dd class="r1"><span class='object_link'><a href="Query.html" title="Brauser::Query (class)">Query</a></span></dd> <dt class="r2 last">Defined in:</dt> <dd class="r2 last">lib/brauser/query.rb</dd> </dl> <div class="clear"></div> <h2>Overview</h2><div class="docstring"> <div class="discussion"> <p>Methods to make queries.</p> </div> </div> <div class="tags"> </div> <h2> Instance Method Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small> </h2> <ul class="summary"> <li class="public "> <span class="summary_signature"> <a href="#accepts%3F-instance_method" title="#accepts? (instance method)">- (Boolean) <strong>accepts?</strong>(langs = []) </a> </span> <span class="summary_desc"><div class='inline'><p>Check if the browser accepts the specified languages.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#is%3F-instance_method" title="#is? (instance method)">- (Boolean) <strong>is?</strong>(names = [], versions = {}, platforms = []) </a> </span> <span class="summary_desc"><div class='inline'><p>Checks if the browser is a specific name and optionally of a specific version and platform.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#on%3F-instance_method" title="#on? (instance method)">- (Boolean) <strong>on?</strong>(platforms = []) </a> </span> <span class="summary_desc"><div class='inline'><p>Check if the browser is on a specific platform.</p> </div></span> </li> <li class="public "> <span class="summary_signature"> <a href="#v%3F-instance_method" title="#v? (instance method)">- (Boolean) <strong>v?</strong>(versions = {}) </a> </span> <span class="summary_desc"><div class='inline'><p>Checks if the browser is a specific version.</p> </div></span> </li> </ul> <div id="instance_method_details" class="method_details_list"> <h2>Instance Method Details</h2> <div class="method_details first"> <h3 class="signature first" id="accepts?-instance_method"> - (<tt>Boolean</tt>) <strong>accepts?</strong>(langs = []) </h3><div class="docstring"> <div class="discussion"> <p>Check if the browser accepts the specified languages.</p> <p>This version returns a boolean and it is equal to append a call to <code>#result</code> to the method `#accepts.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>langs</span> <span class='type'>(<tt>String|Array</tt>)</span> <em class="default">(defaults to: <tt>[]</tt>)</em> — <div class='inline'><p>A list of languages to match against.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if current browser matches, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 96 97 98</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/brauser/query.rb', line 96</span> <span class='kw'>def</span> <span class='id identifier rubyid_accepts?'>accepts?</span><span class='lparen'>(</span><span class='id identifier rubyid_langs'>langs</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='ivar'>@result</span> <span class='op'>?</span> <span class='ivar'>@target</span><span class='period'>.</span><span class='id identifier rubyid_accepts?'>accepts?</span><span class='lparen'>(</span><span class='id identifier rubyid_langs'>langs</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='ivar'>@result</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="is?-instance_method"> - (<tt>Boolean</tt>) <strong>is?</strong>(names = [], versions = {}, platforms = []) </h3><div class="docstring"> <div class="discussion"> <p>Checks if the browser is a specific name and optionally of a specific version and platform.</p> <p>This version returns a boolean and it is equal to append a call to <code>#result</code> to the method <code>#is</code>.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>names</span> <span class='type'>(<tt>Symbol|Array</tt>)</span> <em class="default">(defaults to: <tt>[]</tt>)</em> — <div class='inline'><p>A list of specific names to match. Also, this meta-names are supported: <code>:capable</code> and <code>:tablet</code>.</p> </div> </li> <li> <span class='name'>versions</span> <span class='type'>(<tt>Hash</tt>)</span> <em class="default">(defaults to: <tt>{}</tt>)</em> — <div class='inline'><p>An hash with specific version to match against. Need to be in any form that <code>#v</code> understands.</p> </div> </li> <li> <span class='name'>platforms</span> <span class='type'>(<tt>Symbol|Array</tt>)</span> <em class="default">(defaults to: <tt>[]</tt>)</em> — <div class='inline'><p>A list of specific platform to match. Valid values are all those possible for the platform attribute.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if current browser matches, <code>false</code> otherwise.</p> </div> </li> </ul> <p class="tag_title">See Also:</p> <ul class="see"> <li><span class='object_link'><a href="#v%3F-instance_method" title="Brauser::Queries#v? (method)">#v?</a></span></li> <li><span class='object_link'><a href="#on%3F-instance_method" title="Brauser::Queries#on? (method)">#on?</a></span></li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 66 67 68</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/brauser/query.rb', line 66</span> <span class='kw'>def</span> <span class='id identifier rubyid_is?'>is?</span><span class='lparen'>(</span><span class='id identifier rubyid_names'>names</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_versions'>versions</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_platforms'>platforms</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='ivar'>@result</span> <span class='op'>?</span> <span class='ivar'>@target</span><span class='period'>.</span><span class='id identifier rubyid_is?'>is?</span><span class='lparen'>(</span><span class='id identifier rubyid_names'>names</span><span class='comma'>,</span> <span class='id identifier rubyid_versions'>versions</span><span class='comma'>,</span> <span class='id identifier rubyid_platforms'>platforms</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='ivar'>@result</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="on?-instance_method"> - (<tt>Boolean</tt>) <strong>on?</strong>(platforms = []) </h3><div class="docstring"> <div class="discussion"> <p>Check if the browser is on a specific platform.</p> <p>This version returns a boolean and it is equal to append a call to <code>#result</code> to the method `#on.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>platforms</span> <span class='type'>(<tt>Symbol|Array</tt>)</span> <em class="default">(defaults to: <tt>[]</tt>)</em> — <div class='inline'><p>A list of specific platform to match.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if current browser matches, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 86 87 88</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/brauser/query.rb', line 86</span> <span class='kw'>def</span> <span class='id identifier rubyid_on?'>on?</span><span class='lparen'>(</span><span class='id identifier rubyid_platforms'>platforms</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='ivar'>@result</span> <span class='op'>?</span> <span class='ivar'>@target</span><span class='period'>.</span><span class='id identifier rubyid_on?'>on?</span><span class='lparen'>(</span><span class='id identifier rubyid_platforms'>platforms</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='ivar'>@result</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="v?-instance_method"> - (<tt>Boolean</tt>) <strong>v?</strong>(versions = {}) </h3><div class="docstring"> <div class="discussion"> <p>Checks if the browser is a specific version.</p> <p>This version returns a boolean and it is equal to append a call to <code>#result</code> to the method <code>#v</code>.</p> </div> </div> <div class="tags"> <p class="tag_title">Parameters:</p> <ul class="param"> <li> <span class='name'>versions</span> <span class='type'>(<tt>String|Hash</tt>)</span> <em class="default">(defaults to: <tt>{}</tt>)</em> — <div class='inline'><p>A string in the form <code>operator version && ...</code> (example: <code>>= 7 && < 4</code>) or an hash with specific version to match against, in form <code>{:operator => version}</code>, where operator is one of <code>:lt, :lte, :eq, :gt, :gte</code>.</p> </div> </li> </ul> <p class="tag_title">Returns:</p> <ul class="return"> <li> <span class='type'>(<tt>Boolean</tt>)</span> — <div class='inline'><p><code>true</code> if current browser matches, <code>false</code> otherwise.</p> </div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 76 77 78</pre> </td> <td> <pre class="code"><span class="info file"># File 'lib/brauser/query.rb', line 76</span> <span class='kw'>def</span> <span class='id identifier rubyid_v?'>v?</span><span class='lparen'>(</span><span class='id identifier rubyid_versions'>versions</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span> <span class='ivar'>@result</span> <span class='op'>?</span> <span class='ivar'>@target</span><span class='period'>.</span><span class='id identifier rubyid_v?'>v?</span><span class='lparen'>(</span><span class='id identifier rubyid_versions'>versions</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='ivar'>@result</span> <span class='kw'>end</span></pre> </td> </tr> </table> </div> </div> </div> <div id="footer"> Generated on Sun Jul 14 16:06:02 2013 by <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a> 0.8.6.2 (ruby-1.9.3). </div> </body> </html>